package com.example.forum.services;

import com.example.forum.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description: 文章服务层接口
 * User: DELL
 * Date: 2023-09-21
 * Time: 22:46
 */
public interface IArticleService {
    /**
     * 发布帖子
     *
     * @param article 帖子
     */
    @Transactional
    void create(Article article);

    /**
     * 查询所有帖子的详细信息,包括对应的 user 的信息,
     * 但是不包括文章的 content
     *
     * @return 返回值以帖子的发布时间降序排列
     */
    List<Article> selectAll();

    /**
     * 根据板块id,查询改板块内的所有帖子的信息(不包含content),
     * 包含对应的 user 的信息,结果集根据帖子发布时间降序排列
     *
     * @param boardId
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * 根据用户 id查询所有帖子,不包含帖子关联的板块和用户信息
     *
     * @param userId 用户id
     * @return
     */
    List<Article> selectAllByUserId(Long userId);

    /**
     * 根据帖子id查询文章的详情
     *
     * @param id 文章id
     * @return
     */
    Article selectById(Long id);

    /**
     * 根据帖子id查询文章的详情,包括文章关联的用户信息和板块信息
     *
     * @param id
     * @return
     */
    Article getDetailById(Long id);

    /**
     * 根据帖子id,将对应帖子的 visitCount 加一
     * 特别说明: 该方法不检测是否更新成功
     *
     * @param id 帖子 id
     */
    void updateVisitCount(Long id);

    /**
     * 根据帖⼦Id更新帖⼦ 标题,内容和更新时间
     *
     * @param id      帖⼦Id
     * @param title   标题
     * @param content 内容
     */
    void modify(Long id, String title, String content);

    /**
     * 根据帖子id,将对应帖子的 likeCount 加一
     * 特别说明: 该方法不检测是否更新成功
     *
     * @param id 帖子 id
     */
    void updateLikeCount(Long id);

    /**
     * 根据Id删除帖⼦
     *
     * @param id 帖⼦Id
     */
    @Transactional
    void deleteById(Long id);

}
